home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #11 / Amiga Plus CD - 2002 - No. 11.iso / Tools / ShareMailGiftware / xad_master / xad20 / Docs / xadUnDisk.doc < prev    next >
Text File  |  2002-10-27  |  4KB  |  139 lines
  1. NAME
  2.     xadUnDisk 1.14
  3.  
  4. SYNOPSIS
  5.     xadUnDisk FROM/A,TO,LOWCYL/N,HIGHCYL/N,ENTRY/N,PASSWORD,
  6.     SAVETEXTS/K,NE=NOEXTERN/S,INFO=LIST/S,SHOWTEXTS/S,OW=OVERWRITE/S,
  7.     IG=IGNOREGEOMETRY/S,FORMAT/S,DIMG=DISKIMAGE/S,NAI=NOASKINSERT/S,
  8.     USL=USESECTORLABELS
  9.  
  10. DESCRIPTION
  11.     xadUnDisk is the master shell tool to extract data from
  12.     disk archives.
  13.  
  14.     FROM specifies the disk archive that should be handled. Patterns
  15.     are supported
  16.  
  17.     TO is the destination. This maybe an device name like RAD:
  18.     or any file name. TO is required when LIST option is not
  19.     specified. When extracted to a file, this is a floppy
  20.     image file (often called ADF), which can be used with all
  21.     ADF dealing tools.
  22.     
  23.     LOWCYL and HIGHCYL name the lowest and highest cylinder that
  24.     should be dearchived. Note that some clients do not support
  25.     cylinder based dearchiving and thus ignore these options.
  26.  
  27.     ENTRY specifies the entry, which should be dearchived. Normal
  28.     disk archives only store 1 entry, so there is no need for that
  29.     option, but maybe there are multi-disk-archivers and then you
  30.     need that option to specify the wanted entry. This is a decimal
  31.     number. The first entry has number 1.
  32.  
  33.     PASSWORD can be used to supply a password for unarchiving of
  34.     encrypted archives.
  35.  
  36.     After the SAVETEXTS keyword you may specify a filename which
  37.     should be used to save information texts. The name gets an
  38.     additional point and the text number. E.g. "SAVETEXTS text"
  39.     produces files text.1, text.2, ...
  40.  
  41.     NOEXTERN prohibits the use of external clients for
  42.     recognition purposes.
  43.     
  44.     INFO or LIST prints information about the archive and does not
  45.     do any unarchiving.
  46.     
  47.     SHOWTEXTS tells the program to display information texts, if
  48.     there are some of them in the archive.
  49.     
  50.     OVERWRITE forces the program to overwrite an already existing
  51.     destination file.
  52.     
  53.     IGNOREGEOMETRY forces the tool to ignore wrong drive geometry
  54.     when unarchiving to an device.
  55.  
  56.     Specify USESECTORLABELS when you want to store SectorLabels onto
  57.     disk (no effect for output files). Not all archivers support them
  58.     and not all destination device types support this storage. Most
  59.     time you will not need this switch, as the labels nearly never
  60.     contain useful information.
  61.  
  62.     If the destination disk is not formatted, use FORMAT to do this
  63.     together with writing.
  64.  
  65.     Specify DISKIMAGE, if you want to write a disk image to floppy
  66.     disk. The program also asks you, if you want to handle a file
  67.     as image, if the data type is not detected without DIMG keyword.
  68.     This can also be used to read a disk-image from a device or to
  69.     copy 2 disks.
  70.  
  71.     Specify NOASKINSERT if you do not like to be asked to insert disk.
  72.  
  73. EXAMPLES
  74.     Shell> xadUnDisk archive.dms RAD:
  75.         Unarchive the dms file to RAD:
  76.  
  77.     Shell> xadUnDisk archive.dms LIST
  78.         Tells information about archive.dms file.
  79.  
  80. HISTORY
  81.     xadUnDisk 1.14
  82.     - Added support to handle device input as disk image (skip the
  83.       enter <I> dialog to do so) and patterns.
  84.  
  85.     xadUnDisk 1.13
  86.     - Fixed handling of disk-input and DIMG keyword.
  87.  
  88.     xadUnDisk 1.12
  89.     - Now also supports to read from devices like DF0: to produce disk-
  90.       image files.
  91.  
  92.     xadUnDisk 1.11
  93.     - fixed Enforcer hit.
  94.     - added USESECTORLABELS keyword.
  95.  
  96.     xadUnDisk 1.10
  97.     - Image files are passed through xadmaster.library now.
  98.  
  99.     xadUnDisk 1.9
  100.     - added NOASKINSERT keyword.
  101.  
  102.     xadUnDisk 1.8
  103.     - bug fix
  104.  
  105.     xadUnDisk 1.7
  106.     - bug fix
  107.  
  108.     xadUnDisk 1.6
  109.     - added FORMAT keyword and disk image support
  110.  
  111.     xadUnDisk 1.5
  112.     - before a disk is written, you get ask to insert it or to abort
  113.  
  114.     xadUnDisk 1.4
  115.     - buf fix in report hook
  116.  
  117.     xadUnDisk 1.3
  118.     - bug fix in report hook
  119.  
  120.     xadUnDisk 1.2
  121.     - added output for corrupted files
  122.  
  123.     xadUnDisk 1.1
  124.     - added support for file descriptions
  125.  
  126.     xadUnDisk 1.0
  127.     - First public release.
  128.  
  129. COPYRIGHT
  130.     xadUnDisk is freely distributable for noncommercial use.
  131.  
  132. AUTHOR
  133.     Dirk Stöcker
  134.     Geschwister-Scholl-Straße 10
  135.     01877 Bischofswerda
  136.     GERMANY
  137.     
  138.     Dirk Stoecker <stoecker@epost.de>
  139.